home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / swap.zip / SWAP.DOC < prev    next >
Text File  |  1991-06-29  |  15KB  |  528 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │               THE SWAP SHOP                │
  17.                  │           =======================          │
  18.                  │                                            │
  19.                  │         A Live Door for Many BBS's         │
  20.                  │                                            │
  21.                  │   Game Release Version 3.0 - 01/06/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1990               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │              P.O. Box 9521                 │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │           1200/2400/9600 24 hrs.           │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                      Swap Shop  (C)opyright 1990 - Page 1
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                   Warranty
  77.  
  78.  
  79. This is product is provided "as is" without warranty of any kind.  The
  80. entire risk as to the results and performance of the program is assumed by
  81. you. Futher more, I the author do not warrant, guarantee, or make any
  82. representations regarding the use of, or the results of the use of the program,
  83. and you rely on the program and results solely at your own risk.  I the author
  84. cannot accept responsibility for system damage, loss of profit, or any other
  85. special, incidental, or consequential damages resulting from the use or
  86. inability to use this product.
  87.  
  88.  
  89.                                  Copyright
  90.  
  91.  
  92. The multi-board Swap Shop live game is distributed as SHAREWARE.
  93. Under this concept you may use the SHAREWARE (unregistered) version for a
  94. reasonable period of time, which I consider to be three weeks, after which you
  95. must either register your copy or discontinue usage.
  96.  
  97.  
  98.                                Registration
  99.  
  100. With registration you will recieve the latest registered copy of Swap Shop with
  101. the ability to download any futher updates from Secret Service BBS
  102. at no extra  cost. You will also recieve any support the author can give
  103. in reference to bugs or other problems that may arise in using the game.
  104.  
  105. I feel that sysop's have enough expense without charging a high cost for a game
  106. for their users. I have set the cost of registration at $10.00 which I feel
  107. if people will follow the shareware concept will be enough to cover shipping
  108. and handling and encourage me to write more doors.
  109. See registration.txt in the .zip  for ordering instructions.
  110.  
  111.  
  112.                                Distribution
  113.  
  114. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  115. version of The Multi-board Swap Shop Live Game provided that all files
  116. contained in the original Swap Shop archive are distributed in their
  117. original unmodified state.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                    Swap Shop  (C)opyright 1990 - Page 2
  133.  
  134.  
  135.  
  136.                                Introduction
  137.                                      &
  138.                                 How To Play
  139.  
  140.  
  141. Swap Shop is a door which allows users to add advertisements and save the
  142. in one of three areas: Wanted to Buy - Wanted to Sell - Wanted to Trade.
  143. They may list the item, its cost, a phone number, and a four line
  144. description or narrative.
  145. Users may then scan through the advertisements. Options for scan are
  146. Scan since last scan, Scan by Area, or Look for KEY words in ads.
  147.  
  148.  
  149.                             Installation and Setup
  150.  
  151. Make a directory on your hard drive and unzip Swap.zip into it.
  152. Run the program Setup.exe and answer the questions as they appear.
  153. Edit the Security.dat file as described below.
  154. If your only running one node then thats about all there is to it!
  155. Read the Batch file setup of the docs to see how to call the game
  156. from your board.
  157.  
  158. Setup,exe creates a Swap.cfg (for one node) and a board.txt file
  159. (if not a wildcat system).
  160.  
  161. The following describes each file:
  162.  
  163.  
  164. Dice.cfg contains:
  165.  
  166. The Secret Service BBS       <-- Name of BBS
  167. C:\BBS\doorinfo.???          <-- Path and filename for BBS info (see below)
  168. NO                           <-- NO or locked COM PORT Baud Rate
  169.  
  170.  
  171. *** Note: The above line that refers to BBS info. file will be based on
  172. your particular board software.
  173.  
  174.    WILDCAT prior to V3.0 ----> CALLINFO.BBS    PCBOARD ---> PCBOARD.SYS
  175.    GAP or WILDCAT 3.0+ ------> DOOR.SYS        SPITFIRE --> SFDOORS.DAT
  176.    QUICKBBS ---> DoorinfoX.def (The X is 1 or 2 depending on node)
  177.  
  178. A proper example of path and filename for BBS info file would be:
  179.                       C:\Wildcat\Callinfo.bbs
  180.  
  181.  
  182.  
  183. NOTE FOR MULTI NODES!
  184. You may now have several .cfg files to allow use on multinode systems.
  185. Use the above .cfg format but name each .cfg file differently. You
  186. may call them what you want as long as you correctly call them from
  187. the batch file command line.
  188.  
  189. Example:    Node1:     game game.cfg
  190.  
  191.             Node2:     game game1.cfg
  192.  
  193. ** If you need non-standard IRQ's or COM Addresses for Multi-nodes read
  194.    the file Port.doc!
  195.  
  196.  
  197.  
  198.                    Swap Shop  (C)opyright 1990 - Page 3
  199.  
  200. USER.DAT contains:
  201.  
  202. This file contains the following user data:
  203.  
  204. "SYSOP","01-06-1991"
  205.  
  206. The program reads this file to determine what your last time in the
  207. door was made. This determines what messages  you will get when you
  208. scan (S)ince your last time on.
  209.  
  210. SECURITY.DAT
  211. ------------
  212. This file contains two lines with a users name on each. REMEMBER: This
  213. file MUST have two lines.
  214. Use an ASCII text editor or Edlin to edit this file. The first line
  215. should be the Sysops name as it appears on the board.
  216. The second line will be any users name that you wish to have full
  217. delete capability in the swap shop.  If you don't wish for anyone
  218. else to have full delete capability (users may delete messages that
  219. THEY entered at all times) then just put any character on the second
  220. line.
  221.  
  222. HELP.TXT contains:
  223.  
  224. This is the instruction file for Swap Shop. When a user selects the
  225. See Instructions option during the game, this file is read for
  226. instructions. This file MUST BE PRESENT and Not altered in any way for
  227. Swap Shop to run properly
  228.  
  229. BOARD.TXT
  230. ---------
  231. Don't worry about this file if you run Setup.exe it creates it!
  232. The setup file will create a one line ASCII file called Board.txt
  233. If your running Wildcat prior to version 3.0 then there should
  234. be NO Board.txt file in the game directory.
  235. For boards other than Wildcat! board.txt will exist in the game
  236. directory and will have one line with one of the following on it:
  237.  
  238. For QuickBBS ---------------> QBBS     For Spitfire-->SPITFIRE
  239. For GAP or Wildcat 3.0+ ----> GAP      For PCBoard -->PCB
  240.  
  241.  
  242.                           List of Files In Archive
  243.  
  244. The following files are either found in your Swap Shop .ZIP or will be
  245. created during the runtime execution of the game.
  246.  
  247.  
  248. SWAP.EXE    <--- Executable Program.
  249.  
  250. SETUP.EXE   <--- Setup File for Game
  251.  
  252. USER.DAT    <--- Store User's Name, Last Play Date & Score.
  253.  
  254. HELP.TXT    <--- Instructions Used By Program.
  255.  
  256. SWAP.DOC    <--- This File.
  257.  
  258. SECURITY.DAT <--- Two line txt file that holds master security names
  259.  
  260. SWAP.FIL     <--- Created when ad is entered, holds message info.
  261.  
  262. Register.txt <--- Registration form for Mike Wilson games
  263.  
  264.                    Swap Shop  (C)opyright 1990 - Page 4
  265.  
  266.  
  267.  
  268.                                   Batch Files
  269.                                =================
  270.  
  271.  
  272. Be sure that you have edited or created the Swap.cfg file with the correct
  273. information as described earlier in these docs. The individual setups do not
  274. repeat this necessary process.
  275.  
  276.  
  277.  
  278.  
  279. Wildcat! 1.13 & 2.0+ Setup:
  280. ---------------------------
  281. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  282.  
  283.    ECHO OFF
  284.    CD \WILDCAT\DOORS\SWAP
  285.    SWAP SWAP.CFG
  286.    CD \WILDCAT
  287.    CAT.BAT
  288.  
  289. place this batch file in your Node# directory if running Multi-Nodes or in
  290. your Wildcat (default) directory if single node.
  291.  
  292. Second, Create a sub-directory for the door program such as in the following
  293. example:
  294.  
  295. C:\WILDCAT\DOORS\SWAP
  296.  
  297. Third, put the Swap Shop game files in the \WILDCAT\DOORS\SWAP directory.
  298.  
  299. Forth, add this game to your live program menu for user selection and your
  300. ready to run the door.
  301.  
  302. If this is a little unclear then please read your systems documentation for
  303. more detailed instructions.
  304.  
  305. If you use a door monitoring program then read their documentation for
  306. their specific setup.
  307.  
  308.  
  309. Gap Setup:
  310. ----------
  311. First, add the number and name of the door to your menu. This will allow the
  312. user to select the door by number.
  313.  
  314. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  315. directory. Following is an example line to add:
  316.  
  317.    TD 10
  318.  
  319. where 'TD' stands for the name of the batch file (shown below) to invoke the
  320. the door and '10' is the required security level.
  321.  
  322. Third, create a sub-directory for Swap Shop to be placed in. And example
  323. would be:
  324.  
  325. C:\GAP\SWAP
  326.  
  327. place all the files in the SWAP.ZIP archive inside this directory.
  328.  
  329.  
  330.                    Swap Shop  (C)opyright 1990 - Page 5
  331.  
  332.  
  333.  
  334. Forth, create a batch file called SWAP which should be placed in the
  335. default directory. Following is example contents of this file:
  336.  
  337.    ECHO OFF
  338.    CD\GAP\SWAP
  339.    SWAP SWAP.CFG
  340.    CD\GAP
  341.    GAP
  342.  
  343. the last line in the SWAP file should invoke the batch file which loads
  344. the GAP BBS system.
  345.  
  346. If this is a little unclear then please read your systems documentation for
  347. more detailed instructions.
  348.  
  349. If you use a door monitoring program then read their documentation for
  350. their specific setup.
  351.  
  352.  
  353.  
  354.  
  355. Spitfire Setup:
  356. ---------------
  357. First edit your SFDOOR.MNU and add the following line. If you are not running
  358. and doors at this time you will need to create this file.
  359.  
  360.    TURBODICE, 10
  361.  
  362.    Where Swap Shop is the name of the door to appear on your menu and the 10
  363.    is the lowest security level that will be allowed to enter the door. Don't
  364.    forget the comma (,) after the name.
  365.  
  366. Second create a sub-directory to place the door game in. In this example we
  367. will use 'C:\SF\DOOR_A' for the game directory.
  368.  
  369. Third move all the files in the SWAP.ZIP archive into this directory.
  370.  
  371. Forth edit your SF.BAT file adding the following lines.
  372.  
  373. :DOOR_A
  374.    CD\SF\DOORS_A
  375.    SWAP SWAP.CFG
  376.    CD\SF
  377.    GOTO LOOP
  378.  
  379. Fifth, rerun Sf.BAT and your ready to begin play.
  380.  
  381. If this is a little unclear then please read your systems documentation for
  382. more detailed instructions.
  383.  
  384.  
  385. If you use a door monitoring program then read their documentation for
  386. their specific setup.
  387.  
  388.  
  389. PCBoard 14.0+ Setup:
  390. --------------------
  391. First, edit your DOORS and DOORSG file so that it shows Swap Shop with the door
  392. number relating to it's position in DOORS.DAT.
  393.  
  394. Second, edit the DOORS.DAT file so that it includes Swap Shop.
  395.  
  396.                    Swap Shop  (C)opyright 1990 - Page 6
  397.  
  398.  
  399. Third, create a sub-directory for Soli-Tree to be placed in. And example
  400. would be:
  401.  
  402. C:\PCB\SWAP
  403.  
  404. place all the files in the SWAP.ZIP archive inside this directory.
  405.  
  406. Forth, create a batch file called SWAP which should be placed in the
  407. default directory. Following is example contents of this file:
  408.  
  409.    ECHO OFF
  410.    CD\PCB\SWAP
  411.    SWAP SWAP.CFG
  412.    CD\PCB
  413.    BOARD
  414.  
  415. the last line in the SWAP file should invoke the batch file which loads
  416. the PCboard BBS system.
  417.  
  418. If this is a little unclear then please read your systems documentation for
  419. more detailed instructions.
  420.  
  421. If you use a door monitoring program then read their documentation for
  422. their specific setup.
  423.  
  424.  
  425. QuickBBS Setup:
  426. ---------------
  427. First, add the game to your games menu and select the correct type for doors.
  428.  
  429. Second, create a sub-directory for the game and move all the files from the
  430. zip file to this directory.
  431.  
  432. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  433. Since QuickBBS only supports one node at this time then this file should be
  434. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  435. of the configuration file.
  436.  
  437.    Note: It was told to me that the upcoming 3.0 version of QucikBBS will
  438.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  439.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  440.          where you can specify this new name as well as any others.
  441.  
  442. Forth, create a batch file called SWAP which should be placed in the
  443. default directory. Following is example contents of this file:
  444.  
  445.    ECHO OFF
  446.    CD\QUICKBBS\SWAP
  447.    SWAP SWAP.CFG
  448.    CD\QUICKBBS
  449.    QBBS.BAT
  450.  
  451.  
  452. the last line in the SWAP file should invoke the batch file which loads
  453. the QuickBBS system.
  454.  
  455. If this is a little unclear then please read your systems documentation for
  456. more detailed instructions.
  457.  
  458. If you use a door monitoring program then read their documentation for
  459. their specific setup.
  460.  
  461.  
  462.                    Swap Shop  (C)opyright 1990 - Page 7
  463.  
  464.  
  465.                             Technical Support
  466.  
  467. If you have problems with the Multi-Board Swap Shop live game you may
  468. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.                               Order Information
  476.  
  477.  
  478. Just mail $10.00 Check or Money Order or Cash to:
  479.  
  480. MASTERCARD and VISA also welcome!
  481.  
  482. Mike Wilson
  483. P.O. Box 9521
  484. Huntington, WV
  485.             25704
  486.  
  487. Make Checks out to Mike Wilson.
  488. All funds U.S.!
  489.  
  490. Special thanks to Jeff Sumberg for some great C routines used in this game!
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.                    Swap Shop  (C)opyright 1990 - Page 8